QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Light Data

Labels

ASCII
LightData
Binary
lght ( = 0x6C676874 )

Data Format

Boolean             isOn
Float32             intensity
ColorRGB            color
isOn
A value of True indicates that the parent light is active (is on). A value of False indicates that the parent light is inactive (is off).
intensity
The intensity of the parent light at its source. The value in this field must be in the closed interval [0, 1]. 0 is the minimum value; 1 is the maximum value.
color
The RGB color of the parent light.

Data Size

20

Description

A light data object specifies the color and source intensity of a parent light, and whether that light is currently active or inactive. A light object that does not have a light data object as a child object should be given the default values indicated below.

A value of less than 1.0 in the intensity field of a light data object affects the color of the parent light.

Parent Hierarchy

Data.

Parent Objects

A light data object always has a parent object; the parent object is always a light object.

Child Objects

None.

Example

Container (
    AmbientLight ( )
    LightData (
        True                        # is on
        0.75                        # intensity
        0.7 0.3 0.4                 # color
    )
)

Default Setting

True            # is on
1.0             # intensity (full)
1 1 1           # color (white)

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |